home *** CD-ROM | disk | FTP | other *** search
/ Network Support Library / RoseWare - Network Support Library.iso / logbatch / say2.exe / SAYINGS.DOC < prev    next >
Text File  |  1991-08-26  |  9KB  |  181 lines
  1.  
  2. SAYINGS is a *free* program that displays a "message for the day" on your
  3. screen.  It gets its "sayings" from an easily-modified text file called 
  4. SAYINGS.DAT, so if you have your own quotes that you'd like to add to the 
  5. file, you can do so with any text editor.  Message displays may be in
  6. a color window that disappears when you press a key, or just dumped on
  7. your screen (preferred mode for your AUTOEXEC.BAT file, so you don't have
  8. to press a key, and you'll have something to read while all that stuff 
  9. loads!).
  10.  
  11.  
  12. >-
  13. >-  Using SAYINGS
  14. >-
  15. The sayings program is easy to use, just type SAYINGS at the DOS prompt
  16. and it will select a quote from the SAYINGS.DAT file and display it on
  17. your screen in a color window in the center of your screen.  You can add
  18. your own quotes (see 'The SAYINGS.DAT File'), or even keep separate data
  19. files for each user on your network.  Sayings normally looks for its 
  20. data in the same directory that it resides in, but you can keep it anywhere
  21. you like.  Let's talk about some of the options you can use with SAYINGS.
  22.  
  23.  
  24. >-
  25. >-  Command-Line Options
  26. >-
  27. The /? Option: Help Screen
  28. If you need a quick display of all of the command-line options for SAYINGS,
  29. use the /? or -? option (you can use a / or - with any of the options).  In
  30. other words, just type SAYINGS /?.
  31.  
  32. The /C# Option: Selecting Colors
  33. The default mode for SAYINGS is window mode.  There are seven colorsets
  34. that can be selected for the window colors by using the /C# option, where
  35. # is a number from 1 to 7.  Try them all and select one that pleases you.
  36. If you have a monochrome monitor, try number 7.
  37.  
  38. The /T Option: Text mode
  39. If you don't like the windows, or you want to display a saying without 
  40. requiring a keypress to continue processing, use text mode.  If you type
  41. SAYINGS /T, you'll get a flat ascii dump of a message on your screen, and
  42. it won't wait for you to press a key.  This is most handy in batch files;
  43. I have several (including my AUTOEXEC file) that display a message in text
  44. mode and then continue with several other tasks that take a while to execute.
  45.  
  46. Using a Different Data File
  47. You can use SAYINGS with any file that contains a list of quotes that it
  48. understands; it doesn't have to be called SAYINGS.DAT, and it doesn't have
  49. to reside in the same directory as SAYINGS.EXE.  Just give SAYINGS a path
  50. specification for the file that you want to use, and it will attempt to
  51. read that file and select a saying from it.  If the file can't be found, 
  52. you'll get an error message.
  53.  
  54. The ability to keep SAYINGS.EXE and SAYINGS.DAT in separate directories
  55. is handy on networks.  You can keep the EXE file in a protected area, and
  56. the DAT file someplace where everyone can add their own.  Better yet, you
  57. can have one in each user's home directory.  If you have an environment
  58. variable called USR set to the user's login name (as most networks do),
  59. just run SAYINGS in the login script as SAYINGS F:\USERS\%usr%\SAYINGS.DAT
  60. or SAYINGS F:\COMMON\%usr%.DAT.
  61.  
  62.  
  63.  
  64. >-
  65. >-  The SAYINGS.DAT File
  66. >-
  67. Adding your own sayings to the "database" is easy.  Open SAYINGS.DAT
  68. with your favorite text editor, and you'll quickly see how it works.
  69. Each line in the file is one complete "saying", and sayings can span
  70. multiple lines by separating them with a '|' character.  For instance,
  71. this line:
  72.  
  73. Fact:||Red lights always last|longer than green ones.
  74.  
  75. will appear as a 4 line message on the screen (there's a blank line 
  76. after "Fact:").  If I didn't explain that clearly enough, just open up 
  77. SAYINGS.DAT and take a look, I'm sure it'll be pretty apparent to you.
  78.  
  79. A few notes about the SAYINGS.DAT file follow.  You may have noticed 
  80. that the sayings I gave you (over 850 of them!) are in sorted order.
  81. There's no reason for that other than my own cravings for neatness; the
  82. sayings may be listed in any order.  Keep in mind that longer sayings
  83. have a greater chance of being selected than shorter ones, so you may
  84. want to refrain from adding quotes that are several paragraphs long.
  85. Also, make sure that each line in the saying are short enough to fit
  86. on your screen.  If you have an 80-column screen and you add a saying
  87. that's 90 columns long, SAYINGS will give you an error message when it
  88. tries to display that particular message in a window (see the section 
  89. on SAYCHK to check for oversized messages!) or, if you're running in
  90. text mode, it will wrap around on the screen.  Just add a '|' somewhere
  91. in the middle to break it into two lines, and you'll be fine!
  92.  
  93. As you're adding your sayings you may want to see them to make sure 
  94. that they're centered properly, or whatever.  Here's a little trick:
  95. just put your saying into a file all by itself, and then tell SAYINGS
  96. to use that file as its data file.  If you've put it in a file called
  97. MINE, type SAYINGS MINE.
  98.  
  99.  
  100. >-
  101. >-  The SAYCHK Utility
  102. >-
  103. In the early days of SAYINGS, users would get a "Message too long" error
  104. occasionally, but no indication of which message was too long to fit in
  105. a window or where it was in the file.  The SAYCHK utility will search 
  106. through your entire SAYINGS.DAT file looking for messages that won't fit
  107. in a window on your screen.  When it finds one, it tells you what line 
  108. number it is on, and prints a copy of that message on your screen.  That
  109. way, you can ensure that you (or anyone else) will never be disappointed
  110. by a "Message too long" error.
  111.  
  112. If you just run SAYCHK, it will look for SAYINGS.DAT in the current 
  113. directory.  If you want to check any other file you have to specify a
  114. path to that file.  For instance, you can run SAYCHK D:\QUIPS.TXT.
  115.  
  116. The important part to remember is that SAYCHK only checks that the sayings
  117. can be displayed on the _current_ video screen.  So if you're in 132 column
  118. mode and you run SAYCHK, it will assure you that none of the sayings are
  119. too long to be displayed on a 132 column screen.  But if you switch to
  120. 80 column mode later, you could still encounter a message that is too long
  121. for your screen.  The best idea is to switch to the smallest screen that
  122. you'll ever use before you run SAYCHK.  For most people, this discussion is
  123. irrelevant; most displays are 80 columns by 25 lines, so just run SAYCHK 
  124. once after you've added your new sayings and forget about it.
  125.  
  126. If you need it, SAYCHK also has a help screen that can be viewed with the 
  127. /? option.
  128.  
  129.  
  130. >-
  131. >-  Why FreeWare?
  132. >-
  133. This program is provided to you as freeware, mostly because I'm tired of
  134. seeing people trying to make money off of trivial programs, *especially* 
  135. the ones that display obnoxious messages with lots of long beeps telling 
  136. you that you should send all your money to someone who just figured out 
  137. how to use their compiler.  This program is at least as good as any other
  138. similar package out there, features easily customized messages, and it's 
  139. free!  Shareware is a great concept; let's not ruin it with greed.
  140.  
  141. This program carries no warranty of any kind, use it at your own risk; the
  142. author will not be held responsible for any damages to your system caused
  143. by use of the program, though it would be truly interesting to hear how
  144. someone could possibly hurt themselves with something as harmless as
  145. this.  No upgrades or revisions to this program are planned, but more
  146. unlikely accidents have happened in the past.  If you have comments, 
  147. suggestions, insults, bug reports, or whatever drop me a line by either 
  148. US Mail or CompuServe eMail (please don't phone).  If you send a disk,
  149. a self-addressed stamped envelope, and maybe a neighborly letter I'll 
  150. send you even more free goodies that I've cooked up over the years!
  151.  
  152.                    Scott Wertz   CompuServe 71541,3051
  153.                    9740 Michael Drive
  154.                    Streetsboro, OH  44241
  155.  
  156.  
  157.  
  158. >-
  159. >-  Version Release Information
  160. >-
  161.  
  162. SAYINGS Version 1.0  Initial Release.  Displays sayings in a color window
  163.                      of variable size.  Posted on CompuServe IBMNEW forum.
  164.                      This version also appeared in "Stupid PC Tricks" by
  165.                      Bob LeVitus and Ed Tittel, Addison Wesley Publishing
  166.                      Company (c)1991.  ISBN 0-201-57759-3.  Thanx Ed!
  167.         Version 1.1  Added ability to specify a data file other than
  168.                      SAYINGS.DAT, possibly in a different directory.
  169.         Version 1.2  Replaced the random number generator - some sayings
  170.                      were never being displayed!
  171.  
  172.         Version 2.0  Complete rewrite.
  173.                      Ported from Microsoft C to Borland C.
  174.                      Rewrote window-drawing routines, added colorsets.
  175.                      Replaced random number generator again, better than ever.
  176.                      Added /TEXT option to bypass windows.
  177.                      Added help screen.
  178.                      Included SAYCHK utility.
  179.                      Posted on CompuServe.
  180.  
  181.